home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 028a / pkinsv65.zip / PKINSHIS.DOC < prev    next >
Text File  |  1991-10-22  |  13KB  |  361 lines
  1.  
  2.      PKinsert History Documentation (in Reverse Order)         Page 1  of 6
  3.  
  4.  
  5.                                   Version 6.5
  6.                           Released October 22nd, 1991
  7.  
  8.      Refer to  the Pkinsert.Doc  manual for  upgrade instructions.  Special
  9.      thanks to John Theos from AAxiss BBS for Beta testing.
  10.  
  11.      New Features
  12.      ~~~~~~~~~~~~
  13.      Errorlevel 113 exit for 'Unknown Configuration File Format'.
  14.      Errorlevel 114 exit for 'Unable to Locate File' (see next feature).
  15.  
  16.      Depending on  the configuration  options chosen,  Pkinsert will verify
  17.      the  location of  the  executable it  will  need (Pkzip,  Pkunzip, and
  18.      Scan).   Since Pkinsert  moves  around quite  a  lot (keeps  DOS shell
  19.      commands short), it  will ONLY search  Pathed directories.  Failure to
  20.      locate a needed file will cause Pkinsert to end with an error.
  21.  
  22.      If  a  Pcboard  V14.5a  Pcboard.Sys or  Door.Sys  file  exists  in the
  23.      start-up directory, Pkinsert will log  the node number, user name, and
  24.      bps rate (and city if Door.Sys  is available).  Pkinsert will also use
  25.      the node number  to create it's work  directory, overriding a previous
  26.      node number  value.  Node number  priority sequence  follows (least to
  27.      most):
  28.  
  29.          Configuration File
  30.          Environment Variable
  31.          Command Line
  32.          Pcboard.Sys
  33.          Door.Sys
  34.  
  35.      Improved the standard log file output.   Now includes many of the same
  36.      results as the Fail and Pass log files.
  37.  
  38.      I finally had time  to incorporate a feature  which had been pinned on
  39.      my cork board  for quite a while,  called "Tagline History".  PKinsert
  40.      will keep  a record  of past  system Taglines  in the  archive comment
  41.      screen.  SysOps  and Users  can then  track the  trajectory an archive
  42.      took through various systems.  This  feature is enabled by setting the
  43.      "Number of Taglines to Keep :"  bigger than zero.   Pkinsert must also
  44.      Test, Delete,  or Scan  in order to  pick up  the tagline information.
  45.      When disabled, PKinsert will clear any old Histories.
  46.  
  47.      Note -   Pkinsert  recognizes   taglines  through  a   unique  4  byte
  48.               signature.  Other utilities  wishing to be  compatible or use
  49.               Pkinsert's  tagline info,  should use  this standard.   The 4
  50.               byte signature  comes immediately  after a  Cr/Lf sequence in
  51.               the archive comment.
  52.  
  53.               Signature (in Hex):  FF 08 xx FF {Tagline}
  54.  
  55.      Pkinsert will not delete Pkzip.Exe and Pkunzip.Exe from any file named
  56.      Pkz###.Exe (where ### is  bigger or equal to  110).  You can therefore
  57.      enter Pkzip.Exe and Pkunzip.Exe as filespecs in the Pkinsdel.Lst file,
  58.      without worrying about killing Pkzip upgrades.  :)
  59.  
  60.      
  61.  
  62.      PKinsert History Documentation (in Reverse Order)         Page 2  of 6
  63.  
  64.  
  65.  
  66.      Previously, if  disk space  ran short  (as specified  in configuration
  67.      file), an archive would be renamed to .Err.  In Version 6.5 an archive
  68.      will be  renamed to  .Hld (configurable) if  a file  measures 0 bytes,
  69.      disk space runs out, or the file is not a valid archive (Rename option
  70.      must be enabled).
  71.  
  72.      Another  new  feature is  the  '@Filelist' command  line  option.  Any
  73.      filename preceded  with an  '@' symbol will  be expected  to contain a
  74.      list of files to  process.  Each file specification  in this list must
  75.      occupy a separate line.  Wildcarding is accepted.
  76.  
  77.          ie.  Files.Lst
  78.               ~~~~~~~~~
  79.               D:\Arc\*.Zip
  80.               Archive.Zip
  81.               E:\Main\Files\Backup.Z??
  82.               \Work\A*.Tmp
  83.  
  84.          You may also use a combination of directory pipes.
  85.  
  86.          ie.  C:\>Dir D:\Arc >>Files.Lst
  87.               C:\>Dir E:\Main\Files\*.Zip >>Files.Lst
  88.  
  89.          Instead of entering  redundant directory information  you can tell
  90.          Pkinsert to change  drives and directories.   Use the 'Cd' command
  91.          followed by a space, or back-slash, and the directory name.
  92.  
  93.          ie.  Files.Lst
  94.               ~~~~~~~~~
  95.               Archive.Zip
  96.               Cd\Arc
  97.               *.Zip
  98.               Cd E:\Main\Files
  99.               Good*.Zip
  100.               Bad*.Old
  101.               Ugly*.$$$
  102.               Cd\C:\Temp
  103.               Backup.Z??
  104.  
  105.          These techniques can be used together for greatest versatility.
  106.  
  107.          Note -    Normal  array size  boundaries  apply ONLY  to wildcards
  108.                    within this  list.  There is  NO LIMIT to  the amount of
  109.                    filespecs contained  in the  file list.   If you  have a
  110.                    directory of several  thousand archives you  could use a
  111.                    command sequence along these lines:
  112.  
  113.                    C:\>Dir J:\Uploads\*.Zip >>Files.Lst
  114.                    C:\>Pkinsert @*.Lst
  115.  
  116.                    Wildcarding is also acceptable for filelist names.
  117.  
  118.  
  119.  
  120.      
  121.  
  122.      PKinsert History Documentation (in Reverse Order)         Page 3  of 6
  123.  
  124.  
  125.      Bugs Squashed
  126.      ~~~~~~~~~~~~~
  127.      Virus Comment files where not being added to the extended fail log.  I
  128.      was using an "AND" where it should have been "OR".
  129.  
  130.      Redundant CR/LF sequences where being added under odd circumstances.
  131.  
  132.                                   Version 6.4
  133.                          Released September 22nd, 1991
  134.  
  135.      Set maximum  file read  length to 8k.   This solves  a string overflow
  136.      problem reading an  extremely large capture  file (created by shelling
  137.      to  Pkzip).   In  cases  where the  limit  is  exceeded,  an ///EOI///
  138.      (end-of-input) marker  will be  displayed.  This  has no  other effect
  139.      than limiting the amount of text scrolled on the screen.
  140.  
  141.      In order  to properly link  with other PCBoard  archive utilities, the
  142.      handling  of the  Extended Pass  and Fail  logs has  changed.  Details
  143.      follow.
  144.  
  145.          If an Extended Pass log  already exists, Pkinsert will rename this
  146.          log to Fail before appending it's own Fail report.
  147.  
  148.          Ie.  The  archive has  passed test  #1 which  created Pcbpass.Txt.
  149.               Then comes  Pkinsert (test  #2) and  the archive  fails.  The
  150.               Pcbpass.Txt  from  test  #1  is  renamed  to  Pcbfail.Txt and
  151.               Pkinsert appends it's report.
  152.  
  153.          If an Extended Fail log already  exists, it will be used to append
  154.          the Pass or Fail reports.
  155.  
  156.          Ie.  The archive could  fail test #1 but  pass Pkinsert (test #2).
  157.               In this case Pkinsert would append it's Pcbpass.Txt report to
  158.               the already existing Pcbfail.Txt log.
  159.  
  160.          Batch files should  therefore start with deleting  any old Pass or
  161.          Fail logs.  Otherwise Pkinsert will simply append it's reports.
  162.  
  163.                                   Version 6.3
  164.                           Released September 8th, 1991
  165.  
  166.      Pkinsert will recognize and process self-extracting Zips.
  167.  
  168.      File reading and swapping from disk was unbearable.  It turns out that
  169.      for every record accessed,  the last position within  a file was being
  170.      lost.  I have to apologize to everyone for this one ...
  171.  
  172.      When renaming was enabled and Pkinsert ran out of work space (or other
  173.      disk  related errors),  it would  exit  without renaming  the archive.
  174.      Pkinsert will now  rename archives to  .Err on these  occasions.  In a
  175.      batch  file  you  could  move these  .Err  files  to  a  directory for
  176.      re-processing under supervision.
  177.  
  178.      If  a nested  archive was  corrupt and  file renaming  was set  to No,
  179.  
  180.      
  181.  
  182.      PKinsert History Documentation (in Reverse Order)         Page 4  of 6
  183.  
  184.  
  185.      Pkinsert wouldn't clean up it's work directories.
  186.  
  187.      After extracting  nested archives, Pkinsert  wouldn't kill  them as it
  188.      was supposed to.
  189.  
  190.                                   Version 6.2
  191.                             Released August 10, 1991
  192.  
  193.      Reason for Upgrade
  194.      ~~~~~~~~~~~~~~~~~~
  195.      Matthew  Cooley  reported  an  incompatibility  problem  with  the new
  196.      PCBoard V14.5a (Beta) features.
  197.  
  198.      New Features
  199.      ~~~~~~~~~~~~
  200.      /D       Command line option.  Path to Pcb upload description file.
  201.      /TEST    Command line option.
  202.      Zero byte file errorlevel code 112.
  203.      Standard tagline signature developed.  In HEX:  FF 08 xx FF <tagline>.
  204.  
  205.      Bugs Squashed
  206.      ~~~~~~~~~~~~~
  207.      If a virus was found and rename was disabled, Pkinsert would not clean
  208.      it's work directories.
  209.  
  210.                                   Version 6.1
  211.                             Released August 2, 1991
  212.  
  213.      Split code from 3 to 5 modules.
  214.  
  215.      Pkinsert will display any size status file.  V6.0 was limited to 6k.
  216.  
  217.      If Pass/Fail  extended logs  exist, Pkinsert  will delete  them before
  218.      creating a new one.  This saves 2 lines in the Pcbtest.Bat file.
  219.  
  220.      Process error codes from Add and  Delete functions.  They are the ones
  221.      which can report if archive is read-only.
  222.  
  223.      Clean-up work directories before Add and Delete functions.  This gives
  224.      Pkzip a bit more room to create it's work file.
  225.  
  226.      Check files for  unique 4 byte  Zip signature.  This  is more reliable
  227.      than  using file  name  extensions.  No  matter  what name  an archive
  228.      carries, Pkinsert will test it.
  229.  
  230.      New Errorlevel code 111 for illegal archive compression used.
  231.  
  232.      Pkinsert code stands at  2,461 lines in five  Quick Basic V4.5 modules
  233.      and 108,814 bytes compiled.
  234.  
  235.                                   Version 6.0
  236.                              Released July 25, 1991
  237.  
  238.      There's been so many  features added, I can't  remember them all.  The
  239.  
  240.      
  241.  
  242.      PKinsert History Documentation (in Reverse Order)         Page 5  of 6
  243.  
  244.  
  245.      following where the major ones.
  246.  
  247.      Total revamp of the configuration module.
  248.      Pkinsert will process `nested' archives.
  249.      Verbose log files based on results.
  250.      Configurable disk swapping.
  251.      Exit with Dos error levels.
  252.      etc.
  253.  
  254.      The current code stands at 2,260 lines in Quick Basic V4.5.
  255.  
  256.      Special  thanks   to  Steve  Greenspon,   aka  Doodle   Bug,  for  his
  257.      suggestions,  testing, and  listening to  me rant  and rave  about the
  258.      latest sub or function.  (grin)
  259.  
  260.                                   Version 5.1
  261.                             Released April 27, 1991
  262.  
  263.      Fixed an incompatibility problem with COUNTRY.SYS.  Thanks to Yan Wolf
  264.      from Top 50  BBS in Paris, France  for his help  in tracking down this
  265.      problem.
  266.  
  267.                                   Version 5.0
  268.                             Released March 13, 1991
  269.  
  270.      10k Smaller and much faster!  New features include ...
  271.  
  272.      - Random work directory names.
  273.      - 0 byte files are no longer processed.
  274.      - Complete activity logging to disk.
  275.      - All options can be toggled on or off.
  276.      - Configuration path may be entered by environment variable or command
  277.        line.
  278.      - Various configuration file names may be used.
  279.      - PKinsert will change  drives and directories  as it handles archives
  280.        for shorter DOS commands.
  281.      - PKinsert may add the virus scanner version to the archive comment.
  282.      - Compatible with  Digital Research  DOS 5.0  (actually, this  is what
  283.        prompted this new release).
  284.  
  285.                                   Version 4.02
  286.  
  287.      Fixed the  colours in  PKinserts logo.   Also fixed  a variable  I had
  288.      forgotten about.  PKinsert will now process numerous file specs again!
  289.      <Grin>.  PKTMP environment variable is now external.
  290.  
  291.                                   Version 4.00
  292.  
  293.      PKinsert now works  with DOS4! ;-)  Corrupted  archives are caught and
  294.      renamed.   Virus checking  is also  possible using  McAfee Associates'
  295.      SCAN.EXE program.  Work  drive can be  selected for quicker processing
  296.      on  a RAM  Drive.   Configuration is  now  internal.  No  more messin'
  297.      around with a  word processor.  And  last but not  least PKinsert goes
  298.      COLOUR!
  299.  
  300.      
  301.  
  302.      PKinsert History Documentation (in Reverse Order)         Page 6  of 6
  303.  
  304.  
  305.  
  306.                                   Version 3.20
  307.  
  308.      Added  support  for  DOSv4.0.    Uses  prodoor's  TAGLINE  environment
  309.      variable.  Will now skip the archive test if set to [N]o.
  310.  
  311.                                   Version 3.1
  312.  
  313.      Got rid of a few bugs.  The timer feature in v3.0 wasn't working and I
  314.      got  rid of  it.   Also shortened  much  of PKinsert's  output.  Error
  315.      trapping is also much improved!  Let's hope it won't need it.  <Ugg>
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.      
  361.